home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / print / printwin.lha / PrintWin.doc < prev    next >
Text File  |  1993-01-14  |  7KB  |  174 lines
  1. PrintWin by Shachar Shemesh.
  2.  
  3. NOTE
  4. This document is laid out in the "Why, What and How" method.  If you don't
  5. like it, tough.
  6.  
  7. WHY (use it)
  8.  
  9. Or as my dog used to say (when we didn't give him his dinner on time)
  10. "Orph"?  It would appear that Commodore has given us for free a program
  11. that does almost the same thing.  You know what?  You're right.  How stupid
  12. of me.  Well, being as it is that I programed this program anyway, let's
  13. see if it's any good at all.
  14.  
  15. WHAT (does it do)
  16. This program allows you to print to any preferences printer the active
  17. window at the stroke of a key.  I originally developed this software for a
  18. physics authoring program, which produced graphs that had to be printed.  I
  19. though it might be useful to others.
  20.  
  21. HOW (to get it)
  22. This program is freeware.  You can freely redistribute it so long as the
  23. following conditions are met:
  24. - It is distributed with all files. It must contain the following files:
  25. PrintWin
  26. PrintWin.info
  27. PrintWin.doc - this file
  28. PrintWin.doc.info
  29. ReleaseNotes
  30. - All files are unchanged.
  31. - It is not sold for profit.
  32.  
  33. NOTE
  34. The doc was supposed to end here, but being as it is that I haven't said
  35. anything yet, I'll start over.
  36.  
  37. WHY (not use GraphicDump)
  38. Are you kidding?  Have you EVER used GraphicDump.  Sure it's all right to
  39. use GraphicDump if you want to dump whole rasters, but what if you want to
  40. dump just the window you're working on, or if you don't like waiting 10
  41. seconds before the printing starts, or ....  or ....  etc.
  42.  
  43. WHAT (do I do to install)
  44. Installation is very easy.
  45. a) Make sure you are running KickStart 1.2 or later (easy), and Workbench
  46.    1.2 or later (1.3 recommended, 2.04 very recommended).
  47. b) Make sure you have printer.device and parallel.device or serial.device.
  48. c) Set the preferences printer to the right one.
  49.  
  50. HOW (to use it)
  51. Well, that's not very difficult.  All you have to do is type 'PrintWin'
  52. from your locale CLI (no, PrintWin is not localized yet).  PrintWin will
  53. detach itself from the invoking CLI automatically, and the CLI can freely
  54. be closed.  There is no need for either Run or RunBack.  Alternatively,
  55. double click on it's icon.  Either way PrintWin will open a small window
  56. and will do nothing else at this stage.
  57.  
  58. When the time has come and you want to print the active window, press the
  59. left shift and the F1 key.  Depending on whether this is your first
  60. printing, the disk may read a little, and the printing will start.  The
  61. gadget in the PrintWin window will turn from ghosted to active.  Pressing
  62. this gadget will abort the printing.
  63.  
  64. You can also use the PrintWin window to quit PrintWin (now why would you
  65. want to do that?).  This option is also available from a pull down menu.
  66. Quitting PrintWin aborts any printing in progress (any printing started by
  67. PrintWin, of course).
  68.  
  69. Under 2.04 and later kickstarts, the window will also have a zoom gadget.
  70. Pressing it will minimize PrintWin's window.  Pressing it again (you
  71. guessed it) will bring PrintWin back to it's normal size.
  72.  
  73. Whenever PrintWin tries unsuccessfully to print, the screen will beep to
  74. indicate there was a problem in the printing.  This will happen even if the
  75. cause for the failure was PrintWin itself (i.e.  - the printing was aborted
  76. by user).
  77.  
  78. BUGS
  79. *BUGS*, in *MY* program?
  80. All bugs described here are the result of the way the system behaves.
  81. There are no known bugs in version 1.0 of PrintWin.
  82.  
  83. - If printing is aborted, some printers will stay in a strange state in
  84.   which the printer is waiting for more data.  In such case it is best to
  85.   reset the printer.  The most global way I know of resetting a printer is
  86.   by turning it off and on again.  Your printer might have a more specific
  87.   way of doing this, which will usually be more friendly to the hardware
  88.   (for example - HP LaserJet's reset button).
  89.  
  90. - Any changes made to the window while it is being printed will affect the
  91.   part of the window that had not yet been sent to the printer at the time
  92.   of the change.  It is therefor advised not to work with the program
  93.   untill the printing is done.
  94.  
  95. - Some windows, when printed while part of them is obscured, will not print
  96.   the obscured sight.  This has got to do with the window refresh modes,
  97.   and cannot be avoided by PrintWin.  Mail Commodore angry letters, as they
  98.   can easily fix this and it is their responsibility.
  99.  
  100. FUTURE ENHANCEMENTS
  101. Generally, I believe that a programer must be convinced he is putting out a
  102. perfect product, however even I cannot oversee some needed features to this
  103. program, though when I'll have time to put them in is a very good question.
  104. If you think these functions are important let me know (see the end of this
  105. file for how to contact me).
  106.  
  107. - Allow the user to change various preferences settings from within the
  108.   program.  Oh, didn't notice you were here.  Let me introduce you.  Manual
  109.   reader, this is the user.$ User, this is the manual reader.  Perhaps
  110.   you've met (Just an interlude).
  111.  
  112. - Make the PrintWin window hidden most of the time, and only let it pop up
  113.   when printing is started (a very tricky option as it might be hiding the
  114.   active window as soon as it is opened, and because of the bug in the
  115.   system mentioned above cause for the printing to look not as good as
  116.   might be).
  117.  
  118. - Configurable hot key.  It really is not very nice that the hot key is
  119.   fixed to a given key.
  120.  
  121. - Implement as a commodity (under 2.04, of course).
  122.  
  123. Well, just a note - the original hot-key was lshift prtsc (the numeric pad
  124. asterix), but I came to demonstrate the program to someone, he was using an
  125. A600.  I found myself at a computer with no ability to use the hot-key.
  126. Just comes to show you you can't think of everything in advance.
  127.  
  128. HOW TO REACH ME
  129. For all of you with internet access - I can be reached at the following
  130. address
  131. shacha1@ccsg.tau.ac.il
  132.  
  133. Note however that addresses on our system are very mobile, so you had
  134. better look for anyone on that machine with real life name "Shachar
  135. Shemesh".  If possible I'll try to have the address sun@ccsg.tau.ac.il, but
  136. it is not up to me.
  137.  
  138. My real address (and that is not going to change in the near future) is
  139.                               Shachar Shemesh
  140.                               17th Herzel st.
  141.                                  Ra'anana
  142.                                   Israel
  143.  
  144. Also I am known on IRC as TheSun.
  145.  
  146. One final note:
  147. I am very much interested to hear from anyone that uses this program.  Even
  148. if you just got it and put it in your startup-sequence and never touched it
  149. since.  Something of the following spirit:
  150.  
  151. WARNING:  the following letter is totally imaginary.  I did not get such a
  152. letter.  It is only being brought here for the sake of the example.  Any
  153. resemblance between this letter to any other letter, dead or alive, is only
  154. coincidental.
  155.  
  156. From: noone@nowhere.anyplace.here
  157. To: shacha1@ccsg.tau.ac.il
  158. Subject: PrintWin
  159. Date: 29 Feb 91
  160. I've just downloaded PrintWin from an FTP site, and it is looking quite
  161. nice.  I do wish you'd implement those things you said you might,
  162. especially the option which writes any program I want without me doing any
  163. work.
  164. --
  165. "Everybody is me"
  166. noone@nowhere.anyplace.here
  167.  
  168.  
  169. Of course, I can tell noone that this option is for registered users only,
  170. but that is really only an example letter.  Please e-mail me if you have
  171. any comment at all about this program.  For example - I thought noone used
  172. the last program I released to the public, until I got mail about it 1 year
  173. after release, so do leave comments.
  174.